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Chapter 1 


Application Launcher Framework API 


1.1 References 
[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


[2] Security Policy Enforcement Framework (SPEF) Foundation API, Version 1.0, LiMo Foundation, 1 
February 2008 


1.2 Overview 


The Application Launcher provides abstraction to various application models and exposes common API 
to different subsystems in the platform for an application model. It is a plug-in based architecture, where 
each application model plug-in provides a general command interface and implements interfaces to launch 
and kill application instances. They encapsulate the functionality and the internal details of the application 
model. These plug-ins provide a way to extend and interface Application Launcher with legacy application 
models. Plug-ins can be loaded and unloaded at runtime. 


1.3 Industry Standard 


None 


1.4 External API Documents 


None 


1.5 Plug-in Extension Point Interface 


None 


Application Launcher Framework API 


1.6 Other Interfaces 


None 


1.7 Other Notes 


None 
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Chapter 2 


Module Index 


2.1 Modules 


Here is a list of all modules: 


Application AA 


Module Index 
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Chapter 3 


Class Index 


3.1 Class List 


Here are the classes, structs, unions and interfaces with brief descriptions: 


AppMeETAppInNA E iso a Se a ee ee a ee GS 
AppMerAppModelt ocio... ne. as ka Ee ae a 
AppMerAppModellnterfate t o occo gu e EER Rw ee Ga ao 
ApPpM ar poset Ty 2 34 we ea ee Bare Swe SES Ye ew e a Ped 


Class Index 
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Chapter 4 


File Index 


4.1 File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 
Doxygen) s eo et ene ee SA he EM ek ee ES Shee Eo hake REA A 


File Index 
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Chapter 5 


Module Documentation 


5.1 


Application Model 


5.1.1 Detailed Description 


Error codes for Application Model have not yet been defined. 


Classes 


struct AppMgrAppInfo_t 

struct AppMgrAppModelInterface_t 
struct AppMegrAppSvrIf_t 

struct AppMgrAppModel_t 


Defines 


#define APPMGR_APP_MODEL_TYPE_NAME_LEN_ MAX 64 


Typedefs 


typedef int(x AppMgrAppLaunchFn_t )(int xapp_info, void «*app_instance_info) 

typedef int(x AppMgrAppKillFn_t )(int inst_id, void *app_instance_info) 

typedef int(x* AppMgrAppCommandFn_t )(int inst_id, int command, char *command_data, void 
*app_instance_info) 

typedef int(* AppMgrOnUnloadFn_t )() 

typedef int(x* AppMgrAppSvrAddToRunningListFn_t )(int app_id, int inst_id, pid_t pid, void xapp_- 
instance_info) 

typedef int(* AppMgrAppSvrRemovelnfoFn_t )(int inst_id, int exit_code) 


Functions 


int AppMgrOnLoad (AppMerAppSvrIf_t «svr_if, AppMgrAppModelInterface_t *model_interface) 
void AppMgrAppSetFuncPtr (AppMerAppGetCurrentIdFn_t get_id ptr, 
AppMerAppGetCurrentInstidFn_t get_inst_id_ptr) 
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Variables 


pid_t x AppMgrAppInfo_t::pid 

int AppMgrAppInfo_t::inst_id 

char AppMgrAppInfo_t::path [APP_PATH_LEN_MAX] 

char AppMgrAppInfo_t::param [APP_ARG_LEN_MAX] 

void x AppMgrAppInfo_t::app_model_data 

AppMerAppKillFn_t AppMgrAppModelInterface_t::kill 
AppMgrAppCommandFn_t AppMgrAppModelInterface_t::command 
AppMgrOnUnloadFn_t AppMgrAppModelInterface_t::on_unload 
AppMerAppSvrRemovelnfoFn_t AppMgrAppSvrIf_t::app_svr_remove_info 
void x AppMgrAppModel_t::plugin_handle 
AppMgrAppModelInterface_t AppMgrAppModel t::interface 


5.1.2 Typedef Documentation 


5.1.2.1 typedef int( x AppMgrAppCommandFn_t)(int inst_id, int command, char 
*«command_data, void «app_instance_info) 


This function type is for a function that is implemented by plugin and called when it is commanded to do 
something to an application or to get the application to do something. 


Sync (or) Async: 


This is a Synchronous API. 


Parameters: 
[IN] inst_id Specifies the application instance on which the command is to be executed. 
[IN] command Specifies the command 
[IN] command_data Specifies the data if any to handle to command. 


[IN] app_instance_info Specifies the application instance information that the plugin may have passed 
to App Launcher(on launch of the application instance) for safe keeping. 


Returns: 


This function returns 0 on success or error-code on failure. 


5.1.2.2 typedef int( x AppMgrAppKillFn_t)(int inst_id, void xapp_instance_info) 


This function type is for a function that is implemented by plugin and called in order to terminate an 
application. 


Sync (or) Async: 


This is a Synchronous API. 


Parameters: 


[IN] inst_id Specifies the application instance to be terminated 
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[IN] app_instance_info Specifies the application instance information that the plug-in may have 
passed to App Launcher(on launch of the application instance) for safe keeping. 


Returns: 


This function returns 0 on success or error-code on failure. 


5.1.2.3 typedef int( x AppMgrAppLaunchFn_t)(int «app_info, void «*app_instance_info) 


This function type is for a function that is implemented by plugin and called when an application is 
launched. 


Sync (or) Async: 


This is a Synchronous API. 


Parameters: 
[IN] app_info Specifies the application information to be launched 


[OUT] app_instance_info Specifies the application instance information that may be defined by the 
plugin and may be sent back to the AL for safe keeping.. 


Returns: 


This function returns 0 on success or error-code on failure. 


Remarks: 


struct AppMegrAppInfo_t is filled in by App Launcher except for the pid, which is filled in by the 
plug-in. 


5.1.2.4 typedef int( x AppMgrAppSvrAddToRunningListFn_t)(int app_id, int inst_id, pid_t pid, 
void xapp_instance_info) 


Function of type AppMgrAppSvrAddToRunningListFn_t can be used by the plugin to get the Ap- 
plication Launcher to add the application information to the list of those of running applications. 
Sync (or) Async: 


This is a Synchronous API. 


Parameters: 
[IN] app_id Specifies the application program id 
[IN] inst_id Specifies the instance id of an application instance. 
[IN] pid Specifies the process id 


[IN] app_instance_info Specifies the application instance info the plugin may send to App launcher 
for safe keeping. 
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5.1.2.5 typedef int( x AppMgrAppSvrRemovelnfoFn_t)(int inst_id, int exit_code) 


Function of type AppMgrAppSvrRemovelnfoFn_t will serve as a callback for plugin to get the Appli- 
cation Launcher to remove the application instance related information from the list of running applications 
on application termination. 


Sync (or) Asyne: 


This is a Synchronous API. 


Parameters: 


[IN] inst_id Specifies the application instance that terminated or failed to launch 


[IN] exit_code Specifies the exit status of the application. exit_code indicates abnormal(APP_- 
MGR_APP_ABNORMAL_TERMINATION) or normal(exit status of the possible run-time ve- 
hicle the plugin used to run the app in) termination of the app or failure to launch (APPMGR_- 
ERROR_LAUNCH_FAILURE) 


Remarks: 


A "LiMo.System.AL.Terminate" event is sent out by the Application Launcher once it removes the ap- 
plication information. "LiMo.System.AL .Terminate" event is an asynchronous event and its properties 
are, application program id(app_id) : integer; app instance id(inst_id) : integer; exit_code : integer 


5.1.2.6 typedef int( x AppMgrOnUnloadFn_t)() 
This function type is for a function that is implemented by plugin and called when the plugin is unloaded. 


Sync (or) Async: 


This is a Synchronous API. 


Returns: 


This function returns 0 on success or error-code on failure. 


5.1.3 Function Documentation 


5.1.3.1 void AppMgrAppSetFuncPtr (AppMgrAppGetCurrentIdFn_t get_id_ptr, 
AppMgrAppGetCurrentInstIdFn_t get_inst_id_ptr) 


This API is an AL API that the application model can invoke to set its function pointers of types, 
AppMgrAppGetCurrentIdFn_t and AppMgrAppGetCurrentInstIdFn_t . 
Sync (or) Asyne: 

This is a Synchronous API. 


Parameters: 
[IN] get_id_ptr Specifies the function pointer that is called when an application calls AppM- 
grAppGetCurrentld(). 


[IN] get_inst_id_ptr Specifies the function pointer that is called when an application calls AppM- 
grAppGetCurrentInstId(). 
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Remarks: 


The application plugin developer should implement its own functions to get current application pro- 
gram id and instance id. And pointers to these function should be set by this API. This API is only 
used by Application Model, not by applications. 


5.1.3.2 int AppMgrOnLoad (AppMgrAppSvrlIf_t + svr_if, AppMgrAppModelInterface_t + 
model_interface) 


This function is called when a plugin is loaded and the plug-in must implement it. 


Sync (or) Async: 


This is a Synchronous API. 


Parameters: 


[IN] app_svr_if App Launcher passes pointers to the fucntions of types this structure consists of. The 
plugin can store these values for furthur use. 


[OUT] model_interface Specifies the model interfaces. The plugins have to implement the functions 
of types the struct AppMgrAppModelInterface_t contains and pointers to these functions imple- 
mented are to be bound to model_interface and sent back to AL. 


Returns: 


This function returns true on success, or false otherwise. 
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Chapter 6 


Class Documentation 


6.1 AppMegrApplnfo_t Struct Reference 


#include <app-model.h> 


6.1.1 Detailed Description 


This structure defines application information that AppLauncher passes to the plugin for launching an 
application. 


Public Attributes 


int app_id 

pid_t + pid 

int inst_id 

char path [APP_PATH_LEN_MAX] 
char param [APP_ARG_LEN_MAX] 
void x app_model_data 


The documentation for this struct was generated from the following file: 


* app-model.h 
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6.2 AppMgrAppModel_t Struct Reference 


#include <app-model.h> 


6.2.1 Detailed Description 


This structure defines application model. AppLauncher holds the model list. Each model maps to a plugin. 


Public Attributes 


+ char type [APPMGR_APP_MODEL_TYPE_NAME_LEN_MAX] 
e void + plugin_handle 
e AppMgrAppModelInterface_t interface 


The documentation for this struct was generated from the following file: 


* app-model.h 
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6.3 AppMegrAppModelInterface_t Struct Reference 


#include <app-model.h> 


6.3.1 Detailed Description 


This structure defines the model interfaces. Plugins have to implement these functions 


Public Attributes 
e AppMerAppLaunchFn_t launch 
e AppMerAppKillFn_t kill 


e AppMgrAppCommandFn_t command 
e AppMgrOnUnloadFn_t on_unload 


The documentation for this struct was generated from the following file: 


* app-model.h 
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6.4 AppMerAppSvrIf_t Struct Reference 


#include <app-model.h> 


6.4.1 Detailed Description 


This structure defines services Application Launcher provides the plugin with. 


Public Attributes 


e AppMgrAppSvrAddToRunningListFn_t app_svr_add_to_running list 
+ AppMerAppSvrRemovelnfoFn_t app_svr_remove_info 


The documentation for this struct was generated from the following file: 


* app-model.h 
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File Documentation 


7.1 ComponentOverview.h File Reference 


7.1.1 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 
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